home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 051-060 / amok52 / oberonced / obced.doc < prev    next >
Text File  |  1993-11-04  |  5KB  |  121 lines
  1.  
  2.                             ObCED-Documentation
  3.  
  4. Author: Achim Siebert, Nobileweg 40, 7000 Stuttgart 40.
  5.  
  6. This  program  is  in  the  Public  Domain  (one  of the last ones, maybe -
  7. donations welcome, though).  You may do with it whatever you want to do.  I
  8. would  be  grateful  for  convenient  suggestions  for improvement.  If you
  9. ingeniously change the program then please send me a copy.
  10.  
  11. What it does:
  12.  
  13. ObCED/ObCEDCall  calls  OBERON  and  OLink  out of CygnusEd and shows error
  14. messages.  You don't need AREXX (would be better, though).
  15.  
  16. USAGE: Run ObCED [c-svbcrntmdig1238] [l-bsmdi]
  17.        ObCED     [c][l][e][opt] |[next] |[prev] |[first] |[quit]
  18.        ObCEDCall [c][l][e][opt] |[next] |[prev] |[first] |[quit]
  19.  
  20. Prerequisites for perfect operation of this program:
  21.  
  22. CygnusEd Professional Release 2 loaded.
  23. "OBERON:Fehler-Meldungen" exists (sorry, my brother is still working on the
  24. english version of the OBERON system).
  25. "T:" exists (best place for it: 'RAM:').
  26. Commands "stack" and "path" are in the "C:" directory.
  27. The  file's  name  must  contain the extension ".mod" and correspond to the
  28. name of the module (of course).
  29.  
  30. Files  produced  by  compiler and linker will automatically go to the right
  31. drawer.  You may also use "txt" drawers for the source texts.
  32.  
  33. Memory consumption: nearly 57k.
  34.  
  35. Description of the program's arguments:
  36.  
  37. The  first time you run ObCED there are just two arguments possible:  c-...
  38. for  the  compiler  options to be used as default and l-...  for the linker
  39. options. (Same as for OMake).
  40.  
  41. Warning:   Compiler  and  Linker will be started without any options if you
  42. will  not start ObCED with those arguments - different to the first version
  43. of  ObCED.   You would then have to call ObCED explicitly with the argument
  44. "opt" to get any options.
  45.  
  46. Once started, ObCED will wait in memory for further calls - by "itself", by
  47. ObCEDCall or by AREXX. Now the arguments may be:
  48.  
  49. c :    start compiler.         \
  50. l :    start linker.            > any combination possible.
  51. e :    start the new program.  /
  52. opt:   asks for compiler, linker and program options.  Default for complier
  53.        and linker : "-md".
  54.        Only possible together with "c", "l" and/or "e".
  55. first: show  the first  error, if existing.  Will be invoked  automatically
  56.        if the compiler creates an error file.
  57. next:  show  the  next  error   (only  possible  if still in the same file,
  58.        otherwise shows the first error).
  59. prev:  show the previous error (corresponding to "next").
  60. quit:  guess what...
  61.  
  62. Running  ObCED  again  without arguments is the same as calling it with the
  63. argument "quit".
  64.  
  65. ObCEDCall:   For  those  who don't own AREXX.  This small program sends the
  66. required  option  to the running ObCED.  Usage:  same as ObCED.  Best thing
  67. to  do is to make ObCEDCall resident and call it from a CygnusEd macro.  If
  68. ObCED  is  not  already  in memory, ObCEDCall will try to load it (so ObCED
  69. should  be  found  in the current path - or put it into the C:  directory).
  70. It's function is comparable to that of CygnusEd's "ED".
  71.  
  72.  
  73.                                  Examples:
  74. 1.
  75.  
  76. Call: ObCEDCall cleopt
  77. or:
  78. ObCEDCall -elcopt
  79. or:
  80. ObCEDCall optlec ...
  81.  
  82. Function:   asks  for  compiler  and  linker options, starts OBERON and, if
  83. there are no errors, OLink.  Then it will ask for the new program's options
  84. and starts the executable program with those options.
  85.  
  86. 2.
  87.  
  88. Call: ObCEDCall prev
  89.  
  90. Function:   if there is an error file (...modE) and the module was compiled
  91. before,  then  the previous error will be shown.  If you didn't compile the
  92. file using ObCED, then the first error will be shown, if existing.
  93.  
  94.  
  95.                          Calling ObCED from AREXX
  96.  
  97. RX "address ob_ced; option"
  98.  
  99.    where  "option"  is  the  same  as  in  the ObCED(Call) usage, i.e.  the
  100. examples above will look like this:
  101.  
  102. 1. RX "address ob_ced; cleopt"     or:  RX "address ob_ced; copt;lopt;eopt"
  103. 2. RX "address ob_ced; prev"
  104.  
  105. Of  course  you  may  send  the  option  by  using CygnusEd's command "Send
  106. Dos/ARexx  command..."  as  well,  giving  it  the command "address ob_ced;
  107. option";  and  put  it  to any key by using  a macro.  So you won't have to
  108. call RX explicitly.
  109.  
  110. Watch  out:   Don't send ObCED an option it doesn't know.  You may get what
  111. you  want  (  "address  ob_ced;  nonsense"  for  instance  will  start  the
  112. executable, because there is an "e" in the string!).
  113.  
  114. TIP:   start  CygnusEd  with  the "-keepio" option.  This will speed up the
  115. error  messages  dramatically,  because  CygnusEd  won't  open it's command
  116. window which takes a lot of time.
  117.  
  118.  
  119.  
  120. Spread the program, not the word!!! Achim.
  121.